Central de Ajuda

Leitura de 5 min

Erro “Não autorizado” ao Cadastrar Usuário TV Watch

Introdução

O erro “Não autorizado”, retornado ao utilizar a integração de TV Watch TV pode ocorrer durante o processo de cadastro de Usuários TV na plataforma Watch TV integrada ao sistema. Este erro está relacionado à instabilidades de dados, normalmente diretamente ligado ao arquivo JSON, arquivo este fundamental para a comunicação entre as plataformas.

O arquivo JSON é um formato de troca de dados que permite a configuração da integração da plataforma Watch com o IXC, viabilizando o intercâmbio de informações entre os sistemas. Quando implementado no sistema IXC, é gerado um token de autenticação com prazo de expiração, que é atualizado em todas as requisições relacionadas à integração. O erro é exibido quando o sistema perde a comunicação com a Watch devido à expiração do token.

Acesso ao Formulário

Caminhos:

Sistema > Cadastros > TV/SVA > Usuários TV

Sistema > Contratos > aba TV

Causa do Erro

O erro “Não autorizado” ocorre devido a problemas de autenticação entre o sistema e a plataforma Watch TV. As causas mais comuns incluem:

  1. Token de acesso expirado ou inválido;
  2. Credenciais de integração incorretas ou desatualizadas;
  3. Problemas de conectividade com a API da Watch;
  4. Configurações de integração inadequadas no Sistema.

Solução do Erro

Para resolver o erro “Não autorizado” durante o cadastro de Usuário TV Watch, é necessário solicitar um novo arquivo JSON à plataforma. O processo envolve o contato direto com o suporte da Watch TV para requerer a geração de um documento atualizado de configuração. Após receber o novo arquivo, o usuário deve acessar as configurações de integração do sistema, localizar a seção específica da Watch TV e substituir o arquivo JSON existente pelo novo documento recebido.

Passo a Passo: Correção do Erro “Não autorizado” ao Cadastrar Usuário TV Watch

A atualização do arquivo JSON renova as credenciais de autenticação, restabelecendo a comunicação entre os sistemas. É fundamental salvar as novas configurações e verificar se o token de autenticação foi gerado corretamente. Recomenda-se, após a inserção, realizar um teste de cadastro de usuário TV para confirmar que a integração foi restabelecida com sucesso.

URL de Retorno

A comunicação entre o sistema IXC e a plataforma Watch TV ocorre através do uso de um arquivo JSON, gerado com base na URL de retorno. A URL de retorno, configurada com a estrutura sistema.com.br/retorno/watch/, é fornecida à plataforma Watch TV como ponto de conexão.

URL de retorno:

Uma URL de retorno (ou callback URL, em inglês) é um endereço na web que é usado como ponto de retorno para um aplicativo ou serviço após a conclusão de uma ação ou processo. Esse conceito é frequentemente utilizado em cenários de integração entre sistemas, como em APIs, autenticação

Para que a plataforma Watch TV possa gerar o arquivo JSON necessário para a integração, envie à equipe Watch a URL de retorno configurada com o domínio de acesso ao sistema IXC.

Exemplo de URL de retorno:

https://seuprovedor.com.br/retorno/watch/

  1. Copie o link de acesso ao seu sistema IXC;
  2. Remova o sufixo /adm.php ou /login.php, mantendo apenas a estrutura base do domínio (ex.: https://seudominio.com.br);
  3. Acrescente ao final do link a seguinte estrutura: /retorno/watch/;
  4. A URL de retorno final terá a seguinte forma: https://seudominio.com.br/retorno/watch/.

Após coletar a URL de retorno, encaminhe-a para a equipe Watch, que será responsável pela geração do arquivo JSON necessário para estabelecer a integração. A equipe técnica da Watch processará a solicitação e enviará o arquivo para reestabelecer a comunicação entre os sistemas. Ao receber o documento, faça o download em seu computador para realizar o upload no sistema IXC e prossiga com as demais etapas:

  1. Acesse o menu Configurações > Integrações > Integrações TV > selecione a integração com a plataforma Watch TV e clique em Editar;
  2. Em seguida, clique no botão Arquivo localizado do lado direito do campo Arquivo JSON. O sistema exibirá os arquivos salvos em sua máquina, selecione o arquivo JSON fornecido e clique em Salvar. O sistema deve gerar um novo token e será exibido no campo Token acesso, indicando sucesso na comunicação entre as plataformas.

Finalização:

Após realizar a ação de todos os passos, o usuário TV pode ser cadastrado e então estará pronto para uso. O controle de acesso é feito diretamente pelas ações do contrato (bloqueio e liberação).

Fluxo de Trabalho

graph TD
    A[Início: Erro Não Autorizado] --> B[Gerar URL de Retorno]
    B --> C[Formatar URL]
    C --> D{URL Válida?}
    D -->|Sim| E[Contatar Suporte Watch]
    D -->|Não| B
    E --> F[Solicitar Novo Arquivo JSON]
    F --> G[Receber Arquivo JSON]
    G --> H[Acessar Configurações IXC]
    H --> I[Localizar Integração Watch TV]
    I --> J[Fazer Upload do Arquivo JSON]
    J --> K[Gerar Novo Token]
    K --> L{Token Gerado?}
    L -->|Sim| M[Testar Cadastro Usuário TV]
    L -->|Não| E
    M --> N{Cadastro Realizado?}
    N -->|Sim| O[Fim: Integração Restabelecida]
    N -->|Não| E

Considerações Finais

O processo de resolução do erro “Não autorizado” na Watch TV demonstra mais do que simplesmente corrigir um problema pontual, essa situação ressalta a necessidade de monitoramento contínuo, atualização de credenciais e adaptação dos mecanismos de integração. A precisão técnica, combinada com uma estratégia clara de solução, permite superar desafios de comunicação entre diferentes plataformas, garantindo a continuidade operacional e a eficiência dos sistemas.

Etiquetas

Integracoes IntegracoesTV IntegracaoWatchTV WatchTV UsuarioTV ErrosComuns ErrosComunsWatch

Leia Também

Visão de gráfico